.ds ABSTRACT no
.TL
Trabalhando com o GNU roff
.AU
Rudá Moura
.AI
Porto Alegre, RS
Março de 2009 (revisão 1)
.AB
O GNU roff (groff) é uma linguagem de processamento de textos descendente do Nroff. Este artigo é um resumo de conhecimentos sobre o groff e demonstra através de exemplos o uso prático desta ferramenta.
.AE
.SH
Macros
.LP
O groff sozinho é bastante cru e necessita de um conjunto de macros para extender as suas funcionalidades. As macros estão armazenadas em
.br
\fC/usr/share/groff/<versão>/tmac/<macro>.tmac\fR.
.LP
O conjunto de macros \fIms\fR (-ms) contém recursos de página para quem deseja escrever artigos. Já o conjunto de macros \fIdoc\fR (-mdoc) é utilizado para quem deseja escrever \fImanpages\fR.
.LP
Um artigo ou documento em groff e que utiliza as macros \fIms\fR começa com as seguintes marcações.
.DS 0
.ft C
\&.ds ABSTRACT RESUMO
\&.TL
Título do artigo
\&.AU
Nome do autor
\&.AI
Informação sobre o autor (geralmente cidade ou instituição)
\&.AB
O resumo (abstract) do documento.
\&.AE
.ft R
.DE
.LP
Pode-se suprimir a apresentação da palavra RESUMO através da marcação\fC.AB no\fR. O comando \fC.ds\fR permite customizar a mensagem original ABSTRACT para a palavra RESUMO em português.
.SH
Número de colunas
.LP
Um documento é formatado em duas colunas através da marcação \fC.2C\fR ou pode-se restaurar ao padrão de uma \%coluna com \fC.1C\fR.
.SH
Seções do documento
.LP
Seções marcam as divisões ou partes do documento.
.DS 0
.ft C
\&.SH
Seção sem numeração
\&.NH
Seção de nível um com numeração (título 1)
\&.NH 2
Seção de nível dois com numeração (título 2)
\&.NH 3
Seção de nível três com numeração (título 3)
.ft R
.DE
.SH
Seção sem numeração
.NH
Seção de nível um com numeração (título 1)
.NH 2
Seção de nível dois com numeração (título 2)
.NH 3
Seção de nível três com numeração (título 3)
.SH
Tipos de parágrafos
.LP
Parágrafo normal com recuo na primeira linha.
.br
\fC.PP\fR
.PP
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
.LP
Parágrafo sem o recuo na primeira linha.
.br
\fC.LP\fR
.LP
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
.LP
Parágrafo com texto LOREM IPSUM em destaque e com recuo de 8 caracteres.
.br
\fC\&.IP "LOREM IPSUM" 8\fR
.IP "LOREM IPSUM" 8
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
.LP
Através da marcação \fC.IP\fR é possível simular o funcionamento de uma lista de itens.
.DS 0
.ft C
\&.IP \\\&(bu
Narrativo
\&.IP \\\&(bu
Lírico
\&.IP \\\&(bu
Dramático
.ft R
.DE
.IP \(bu
Narrativo
.IP \(bu
Lírico
.IP \(bu
Dramático
.LP
Um Parágrafo literal é aquele que considera espaços, tabulações e quebras de linhas do texto e são obtidos com as marcações \fC.DS\fR e \fC.DE\fR.
.DS 0
.ft C
\&.DS
"Two roads diverged in a wood, and I	
I took the one less traveled by,	
And that has made all the difference." (Robert Frost)
\&.DE
.ft R
.DE
.DS
"Two roads diverged in a wood, and I	
I took the one less traveled by,	
And that has made all the difference." (Robert Frost)
.DE
.LP
As marcações \fC.RS\fR e \fC.RE\fR marcam um parágrafo com recuo em relação ao recuo do parágrafo anterior.
.RS
\fC.RS\fR
.br
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
.RS
\fC.RS\fR
.br
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
.br
\fC.RE\fR
.RE
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
.br
\fC.RE\fR
.RE
.LP
As citações são delimitadas pelas marcações \fC.QS\fR e \fC.QE\fR.
.QS
"Two roads diverged in a wood, and I	
I took the one less traveled by,	
And that has made all the difference." (Robert Frost)
.QE
.SH
Fontes, estilos e espacejamento
.LP
Fonte normal \fC.R\fR ou \fC\\fR.
.R
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
.LP
Fonte em negrito \fC.B\fR ou \fC\\fB.
.B
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
.R
.LP
Fonte em itálico \fC.I\fR ou \fC\\fI.
.I
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
.R
.LP
Fonte normal \fC.ft R\fR e fonte de espacejamento fixo \fC.ft C\fR ou \fC\\fC\fR.
.ft C
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
.ft R
.LP
Para forçar uma quebra de linha use a marcação \fC.br\fR. Para pular uma linha em branco \fC.sp\fR ou duas linhas em branco \fC.sp 2\fR.
.LP
.SH
Notas de rodapé.
.DS 0
.ft C
\&.LP
Two roads diverged in a wood, and I	
I took the one less traveled by,	
And that has made all the difference.*
\&.FS
* Por Robert Frost.
\&.FE
.ft R
.DE
.LP
Two roads diverged in a wood, and I	
I took the one less traveled by,	
And that has made all the difference.*
.FS
* Por Robert Frost.
.FE
